home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_qt.idb / usr / freeware / catman / p_man / cat3 / qdatastream.Z / qdatastream
Encoding:
Text File  |  1998-10-28  |  28.2 KB  |  397 lines
  1.  
  2.  
  3.  
  4.      QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm((((3333qqqqtttt))))    TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))   QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm((((3333qqqqtttt))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       QDataStream -    Basic functions    for serialization of binary
  10.       data to a QIODevice
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.       #include <qdatastream.h>
  14.  
  15.     PPPPuuuubbbblllliiiicccc MMMMeeeemmmmbbbbeeeerrrrssss
  16.       QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm (((())))
  17.       QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm ((((    QQQQIIIIOOOODDDDeeeevvvviiiicccceeee **** ))))
  18.       QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm ((((    QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy,,,, iiiinnnntttt    mmmmooooddddeeee ))))
  19.       vvvviiiirrrrttttuuuuaaaallll ~~~~QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm ()
  20.       QQQQIIIIOOOODDDDeeeevvvviiiicccceeee**** ddddeeeevvvviiiicccceeee (((()))) ccccoooonnnnsssstttt
  21.       vvvvooooiiiidddd sssseeeettttDDDDeeeevvvviiiicccceeee (((( QQQQIIIIOOOODDDDeeeevvvviiiicccceeee **** ))))
  22.       vvvvooooiiiidddd uuuunnnnsssseeeettttDDDDeeeevvvviiiicccceeee (((())))
  23.       bbbboooooooollll eeeeooooffff (((()))) ccccoooonnnnsssstttt
  24.       iiiinnnntttt bbbbyyyytttteeeeOOOOrrrrddddeeeerrrr    (((()))) ccccoooonnnnsssstttt
  25.       vvvvooooiiiidddd sssseeeettttBBBByyyytttteeeeOOOOrrrrddddeeeerrrr (((( iiiinnnntttt ))))
  26.       bbbboooooooollll iiiissssPPPPrrrriiiinnnnttttaaaabbbblllleeeeDDDDaaaattttaaaa (((()))) ccccoooonnnnsssstttt
  27.       vvvvooooiiiidddd sssseeeettttPPPPrrrriiiinnnnttttaaaabbbblllleeeeDDDDaaaattttaaaa    (((( bbbboooooooollll ))))
  28.       QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm&&&& ooooppppeeeerrrraaaattttoooorrrr>>>>>>>> (((( QQQQ____IIIINNNNTTTT8888 &&&& iiii ))))
  29.       QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm&&&& ooooppppeeeerrrraaaattttoooorrrr>>>>>>>> (((( QQQQ____UUUUIIIINNNNTTTT8888 &&&& iiii    ))))
  30.       QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm&&&& ooooppppeeeerrrraaaattttoooorrrr>>>>>>>> (((( QQQQ____IIIINNNNTTTT11116666 &&&& iiii    ))))
  31.       QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm&&&& ooooppppeeeerrrraaaattttoooorrrr>>>>>>>> (((( QQQQ____UUUUIIIINNNNTTTT11116666 &&&& iiii ))))
  32.       QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm&&&& ooooppppeeeerrrraaaattttoooorrrr>>>>>>>> (((( QQQQ____IIIINNNNTTTT33332222 &&&& iiii    ))))
  33.       QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm&&&& ooooppppeeeerrrraaaattttoooorrrr>>>>>>>> (((( QQQQ____UUUUIIIINNNNTTTT33332222 &&&& iiii ))))
  34.       QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm&&&& ooooppppeeeerrrraaaattttoooorrrr>>>>>>>> (((( ffffllllooooaaaatttt &&&& ffff ))))
  35.       QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm&&&& ooooppppeeeerrrraaaattttoooorrrr>>>>>>>> (((( ddddoooouuuubbbblllleeee &&&& ffff ))))
  36.       QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm&&&& ooooppppeeeerrrraaaattttoooorrrr>>>>>>>> (((( cccchhhhaaaarrrr ****&&&& ssssttttrrrr    ))))
  37.       QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm&&&& ooooppppeeeerrrraaaattttoooorrrr<<<<<<<< (((( QQQQ____IIIINNNNTTTT8888 iiii ))))
  38.       QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm&&&& ooooppppeeeerrrraaaattttoooorrrr<<<<<<<< (((( QQQQ____UUUUIIIINNNNTTTT8888 iiii ))))
  39.       QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm&&&& ooooppppeeeerrrraaaattttoooorrrr<<<<<<<< (((( QQQQ____IIIINNNNTTTT11116666 iiii ))))
  40.       QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm&&&& ooooppppeeeerrrraaaattttoooorrrr<<<<<<<< (((( QQQQ____UUUUIIIINNNNTTTT11116666 iiii ))))
  41.       QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm&&&& ooooppppeeeerrrraaaattttoooorrrr<<<<<<<< (((( QQQQ____IIIINNNNTTTT33332222 iiii ))))
  42.       QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm&&&& ooooppppeeeerrrraaaattttoooorrrr<<<<<<<< (((( QQQQ____UUUUIIIINNNNTTTT33332222 iiii ))))
  43.       QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm&&&& ooooppppeeeerrrraaaattttoooorrrr<<<<<<<< (((( ffffllllooooaaaatttt ffff ))))
  44.       QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm&&&& ooooppppeeeerrrraaaattttoooorrrr<<<<<<<< (((( ddddoooouuuubbbblllleeee ffff ))))
  45.       QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm&&&& ooooppppeeeerrrraaaattttoooorrrr<<<<<<<< (((( ccccoooonnnnsssstttt cccchhhhaaaarrrr **** ssssttttrrrr ))))
  46.       QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm&&&& rrrreeeeaaaaddddBBBByyyytttteeeessss (((( cccchhhhaaaarrrr    ****&&&&,,,, uuuuiiiinnnntttt &&&& lllleeeennnn ))))
  47.       QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm&&&& rrrreeeeaaaaddddRRRRaaaawwwwBBBByyyytttteeeessss (((( cccchhhhaaaarrrr ****,,,, uuuuiiiinnnntttt lllleeeennnn ))))
  48.       QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm&&&& wwwwrrrriiiitttteeeeBBBByyyytttteeeessss (((( ccccoooonnnnsssstttt cccchhhhaaaarrrr ****,,,, uuuuiiiinnnntttt lllleeeennnn ))))
  49.       QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm&&&& wwwwrrrriiiitttteeeeRRRRaaaawwwwBBBByyyytttteeeessss (((( ccccoooonnnnsssstttt cccchhhhaaaarrrr ****,,,, uuuuiiiinnnntttt lllleeeennnn ))))
  50.  
  51.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  52.       The QDataStream class    provides basic functions for
  53.       serialization    of binary data to a QIODevice.
  54.  
  55.       A data stream    is a binary stream of encoded information
  56.       which    is 100%    independent of the host    computer operation
  57.       system, CPU or byte order. A stream that is written by a PC
  58.       under    DOS/Windows can    easily be read by a Sun    SPARC running
  59.       Solaris.
  60.  
  61.  
  62.  
  63.      Page 1                         (printed 9/22/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm((((3333qqqqtttt))))    TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))   QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm((((3333qqqqtttt))))
  71.  
  72.  
  73.  
  74.       The QDataStream class    implements serialization of primitive
  75.       types, like char, short, int,    char* etc. Serialization of
  76.       more complex data is accomplished by breaking    up the data
  77.       into primitive units.
  78.  
  79.       The programmer can select which byte order to    use when
  80.       serializing data. The    default    setting    is big endian (MSB
  81.       first). Changing it to little    endian breaks the portability.
  82.       We therefore recommend keeping this setting unless you have
  83.       special needs    or requirements.
  84.  
  85.       A data stream    cooperates closely with    a QIODevice. A
  86.       QIODevice represents an input/output medium one can read
  87.       data from and    write data to. The QFile class is an example
  88.       of an    IO device.
  89.  
  90.       Example (write data to a stream):
  91.  
  92.           QFile f( "file.dta" );
  93.           f.open( IO_WriteOnly );              // open file for writing
  94.           QDataStream s( &f    );              // serialize using f
  95.           s    << "the    answer is";              // serialize string
  96.           s    << (Q_INT32)42;                  // serialize integer
  97.           f.close();                  // done
  98.  
  99.       Example (read    data from a stream):
  100.  
  101.           QFile f( "file.dta" );
  102.           f.open( IO_ReadOnly );              // open file for reading
  103.           QDataStream s( &f    );              // serialize using f
  104.           char   *str;
  105.           Q_INT32 a;
  106.           s    >> str >> a;                  // "the answer is" and 42
  107.           f.close();                  // done
  108.           delete str;                  // delete string
  109.  
  110.       In the last example, if you read into    a QString instead of a
  111.       char*    you do not have    to delete it.
  112.  
  113.       See also: QTextStream.
  114.  
  115.      MMMMEEEEMMMMBBBBEEEERRRR FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN DDDDOOOOCCCCUUUUMMMMEEEENNNNTTTTAAAATTTTIIIIOOOONNNN
  116.      QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm::::::::QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm (((())))
  117.       Constructs a data stream that    has no IO device.
  118.  
  119.      QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm::::::::QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm ((((    QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy aaaa,,,, iiiinnnntttt mmmmooooddddeeee ))))
  120.       Constructs a data stream that    operates on a byte array
  121.       throught an internal QBuffer device.
  122.  
  123.       Example:
  124.  
  125.           static char bindata[] = {    231, 1,    44, ...    };
  126.  
  127.  
  128.  
  129.      Page 2                         (printed 9/22/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm((((3333qqqqtttt))))    TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))   QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm((((3333qqqqtttt))))
  137.  
  138.  
  139.  
  140.           QByteArray  a;
  141.           a.setRawData( bindata, sizeof(bindata) );      // a points to bindata
  142.           QDataStream s( a,    IO_ReadOnly );          // open on a's data
  143.           s    >> <something>;                  // read raw bindata
  144.           a.resetRawData( bindata, sizeof(bindata) ); // finished
  145.  
  146.       The QArray::setRawData() function is not for the
  147.       inexperienced.
  148.  
  149.      QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm::::::::QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm ((((    QQQQIIIIOOOODDDDeeeevvvviiiicccceeee **** dddd ))))
  150.       Constructs a data stream that    uses the IO device _d.
  151.  
  152.      QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm::::::::~~~~QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm (((()))) [[[[vvvviiiirrrrttttuuuuaaaallll]]]]
  153.       Destroys the data stream.
  154.  
  155.       The destructor will not affect the current IO    device,    unless
  156.       it is    an internal IO device processing a QByteArray passed
  157.       in the constructor.
  158.  
  159.      iiiinnnntttt QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm::::::::bbbbyyyytttteeeeOOOOrrrrddddeeeerrrr    (((()))) ccccoooonnnnsssstttt
  160.       Returns the current byte order setting.
  161.  
  162.       See also: setByteOrder().
  163.  
  164.      QQQQIIIIOOOODDDDeeeevvvviiiicccceeee **** QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm::::::::ddddeeeevvvviiiicccceeee (((())))    ccccoooonnnnsssstttt
  165.       Returns the IO device    currently set.
  166.  
  167.       See also: setDevice()    and unsetDevice().
  168.  
  169.      bbbboooooooollll QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm::::::::eeeeooooffff (((()))) ccccoooonnnnsssstttt
  170.       Returns TRUE if the IO device    has reached the    end position
  171.       (end of stream or file) or if    there is no IO device set.
  172.  
  173.       Returns FALSE    if the current position    of the read/write head
  174.       of the IO device is somewhere    before the end position.
  175.  
  176.       See also: QIODevice::atEnd().
  177.  
  178.      bbbboooooooollll QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm::::::::iiiissssPPPPrrrriiiinnnnttttaaaabbbblllleeeeDDDDaaaattttaaaa (((()))) ccccoooonnnnsssstttt
  179.       Returns TRUE if the printable    data flag has been set.
  180.  
  181.       See also: setPrintableData().
  182.  
  183.      QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm &&&& QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm::::::::ooooppppeeeerrrraaaattttoooorrrr<<<<<<<< (((( QQQQ____IIIINNNNTTTT11116666 iiii ))))
  184.       Writes a signed 16-bit integer to the    stream and returns a
  185.       reference to the stream.
  186.  
  187.      QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm &&&& QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm::::::::ooooppppeeeerrrraaaattttoooorrrr<<<<<<<< (((( QQQQ____IIIINNNNTTTT33332222 iiii ))))
  188.       Writes a signed 32-bit integer to the    stream and returns a
  189.       reference to the stream.
  190.  
  191.      QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm &&&& QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm::::::::ooooppppeeeerrrraaaattttoooorrrr<<<<<<<< (((( QQQQ____IIIINNNNTTTT8888 iiii ))))
  192.  
  193.  
  194.  
  195.      PPPPaaaaggggeeee 3333                         ((((pppprrrriiiinnnntttteeeedddd 9999////22222222////99998888))))
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm((((3333qqqqtttt))))    TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))   QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm((((3333qqqqtttt))))
  203.  
  204.  
  205.  
  206.       Writes a signed byte to the stream.
  207.  
  208.      QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm &&&& QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm::::::::ooooppppeeeerrrraaaattttoooorrrr<<<<<<<< (((( QQQQ____UUUUIIIINNNNTTTT11116666 iiii    ))))
  209.       Writes an unsigned 16-bit integer to the stream and returns
  210.       a reference to the stream.
  211.  
  212.      QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm &&&& QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm::::::::ooooppppeeeerrrraaaattttoooorrrr<<<<<<<< (((( QQQQ____UUUUIIIINNNNTTTT33332222 iiii    ))))
  213.       Writes an unsigned 32-bit integer to the stream and returns
  214.       a reference to the stream.
  215.  
  216.      QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm &&&& QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm::::::::ooooppppeeeerrrraaaattttoooorrrr<<<<<<<< (((( QQQQ____UUUUIIIINNNNTTTT8888 iiii ))))
  217.       Writes an unsigned byte to the stream    and returns a
  218.       reference to the stream.
  219.  
  220.      QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm &&&& QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm::::::::ooooppppeeeerrrraaaattttoooorrrr<<<<<<<< (((( ccccoooonnnnsssstttt cccchhhhaaaarrrr    **** ssss ))))
  221.       Writes the '\0'-terminated string _s to the stream and
  222.       returns a reference to the stream.
  223.  
  224.       The string is    serialized using writeBytes().
  225.  
  226.      QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm &&&& QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm::::::::ooooppppeeeerrrraaaattttoooorrrr<<<<<<<< (((( ddddoooouuuubbbblllleeee ffff ))))
  227.       Writes a 64-bit floating point number    to the stream using
  228.       the standard IEEE754 format. Returns a reference to the
  229.       stream.
  230.  
  231.      QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm &&&& QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm::::::::ooooppppeeeerrrraaaattttoooorrrr<<<<<<<< (((( ffffllllooooaaaatttt ffff ))))
  232.       Writes a 32-bit floating point number    to the stream using
  233.       the standard IEEE754 format. Returns a reference to the
  234.       stream.
  235.  
  236.      QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm &&&& QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm::::::::ooooppppeeeerrrraaaattttoooorrrr>>>>>>>> (((( QQQQ____IIIINNNNTTTT11116666 &&&& iiii ))))
  237.       Reads    a signed 16-bit    integer    from the stream    and returns a
  238.       reference to the stream.
  239.  
  240.      QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm &&&& QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm::::::::ooooppppeeeerrrraaaattttoooorrrr>>>>>>>> (((( QQQQ____IIIINNNNTTTT33332222 &&&& iiii ))))
  241.       Reads    a signed 32-bit    integer    from the stream    and returns a
  242.       reference to the stream.
  243.  
  244.      QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm &&&& QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm::::::::ooooppppeeeerrrraaaattttoooorrrr>>>>>>>> (((( QQQQ____IIIINNNNTTTT8888 &&&& iiii    ))))
  245.       Reads    a signed byte from the stream.
  246.  
  247.      QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm &&&& QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm::::::::ooooppppeeeerrrraaaattttoooorrrr>>>>>>>> (((( QQQQ____UUUUIIIINNNNTTTT11116666 &&&&    iiii ))))
  248.       Reads    an unsigned 16-bit integer from    the stream and returns
  249.       a reference to the stream.
  250.  
  251.      QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm &&&& QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm::::::::ooooppppeeeerrrraaaattttoooorrrr>>>>>>>> (((( QQQQ____UUUUIIIINNNNTTTT33332222 &&&&    iiii ))))
  252.       Reads    an unsigned 32-bit integer from    the stream and returns
  253.       a reference to the stream.
  254.  
  255.      QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm &&&& QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm::::::::ooooppppeeeerrrraaaattttoooorrrr>>>>>>>> (((( QQQQ____UUUUIIIINNNNTTTT8888 &&&& iiii ))))
  256.       Reads    an unsigned byte from the stream and returns a
  257.       reference to the stream.
  258.  
  259.  
  260.  
  261.      Page 4                         (printed 9/22/98)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm((((3333qqqqtttt))))    TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))   QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm((((3333qqqqtttt))))
  269.  
  270.  
  271.  
  272.      QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm &&&& QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm::::::::ooooppppeeeerrrraaaattttoooorrrr>>>>>>>> (((( cccchhhhaaaarrrr ****&&&& ssss ))))
  273.       Reads    the '\0'-terminated string _s from the stream and
  274.       returns a reference to the stream.
  275.  
  276.       The string is    read using readBytes(),    which allocates    space
  277.       using    new.
  278.  
  279.      QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm &&&& QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm::::::::ooooppppeeeerrrraaaattttoooorrrr>>>>>>>> (((( ddddoooouuuubbbblllleeee &&&& ffff    ))))
  280.       Reads    a 64-bit floating point    number from the    stream using
  281.       the standard IEEE754 format. Returns a reference to the
  282.       stream.
  283.  
  284.      QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm &&&& QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm::::::::ooooppppeeeerrrraaaattttoooorrrr>>>>>>>> (((( ffffllllooooaaaatttt &&&& ffff ))))
  285.       Reads    a 32-bit floating point    number from the    stream using
  286.       the standard IEEE754 format. Returns a reference to the
  287.       stream.
  288.  
  289.      QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm &&&& QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm::::::::rrrreeeeaaaaddddBBBByyyytttteeeessss (((( cccchhhhaaaarrrr ****&&&& ssss,,,, uuuuiiiinnnntttt &&&& llll    ))))
  290.       Reads    the buffer _s from the stream and returns a reference
  291.       to the stream.
  292.  
  293.       The buffer _s is allocated using new. Destroy it with the
  294.       delete operator. If the length is zero or _s cannot be
  295.       allocated, _s is set to 0.
  296.  
  297.       The _l    parameter will be set to the length of the buffer.
  298.  
  299.       The serialization format is an Q_UINT32 length specifier
  300.       first, then the data (_l_e_n_g_t_h bytes).
  301.  
  302.       See also: readRawBytes() and writeBytes().
  303.  
  304.      QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm &&&& QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm::::::::rrrreeeeaaaaddddRRRRaaaawwwwBBBByyyytttteeeessss (((( cccchhhhaaaarrrr **** ssss,,,, uuuuiiiinnnntttt lllleeeennnn ))))
  305.       Reads    _l_e_n bytes from the stream into _e s and returns a
  306.       reference to the stream.
  307.  
  308.       The buffer _s must be preallocated.
  309.  
  310.       See also: readBytes(), QIODevice::readBlock()    and
  311.       writeRawBytes().
  312.  
  313.      vvvvooooiiiidddd QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm::::::::sssseeeettttBBBByyyytttteeeeOOOOrrrrddddeeeerrrr (((( iiiinnnntttt bbbboooo ))))
  314.       Sets the serialization byte order to _b_o.
  315.  
  316.       The _b_o parameter can be QDataStream::BigEndian or
  317.       QDataStream::LittleEndian.
  318.  
  319.       The default setting is big endian. We    recommend leaving this
  320.       setting unless you have special requirements.
  321.  
  322.       See also: byteOrder().
  323.  
  324.  
  325.  
  326.  
  327.      Page 5                         (printed 9/22/98)
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm((((3333qqqqtttt))))    TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))   QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm((((3333qqqqtttt))))
  335.  
  336.  
  337.  
  338.      vvvvooooiiiidddd QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm::::::::sssseeeettttDDDDeeeevvvviiiicccceeee (((( QQQQIIIIOOOODDDDeeeevvvviiiicccceeee **** dddd ))))
  339.       void QDataStream::setDevice(QIODevice    *d ) Sets the IO
  340.       device to _d.
  341.  
  342.       See also: device() and unsetDevice().
  343.  
  344.      vvvvooooiiiidddd QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm::::::::sssseeeettttPPPPrrrriiiinnnnttttaaaabbbblllleeeeDDDDaaaattttaaaa    (((( bbbboooooooollll eeeennnnaaaabbbblllleeee ))))
  345.       Sets or clears the printable data flag.
  346.  
  347.       If this flag is set, the write functions will    generate
  348.       output that consists of printable characters (7 bit ASCII).
  349.  
  350.       We recommend enabling    printable data only for    debugging
  351.       purposes (it is slower and creates bigger output).
  352.  
  353.      vvvvooooiiiidddd QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm::::::::uuuunnnnsssseeeettttDDDDeeeevvvviiiicccceeee (((())))
  354.       Unsets the IO    device.    This is    the same as calling setDevice(
  355.       0 ).
  356.  
  357.       See also: device() and setDevice().
  358.  
  359.      QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm &&&& QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm::::::::wwwwrrrriiiitttteeeeBBBByyyytttteeeessss (((( ccccoooonnnnsssstttt cccchhhhaaaarrrr    **** ssss,,,, uuuuiiiinnnntttt lllleeeennnn
  360.       ))))
  361.       Writes the length specifier _l_e_n and the buffer _s to the
  362.       stream and returns a reference to the    stream.
  363.  
  364.       The _l_e_n is serialized    as an Q_UINT32,    followed by _l_e_n    bytes
  365.       from _s.
  366.  
  367.       See also: writeRawBytes() and    readBytes().
  368.  
  369.      QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm &&&& QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm::::::::wwwwrrrriiiitttteeeeRRRRaaaawwwwBBBByyyytttteeeessss ((((    ccccoooonnnnsssstttt cccchhhhaaaarrrr **** ssss,,,,    uuuuiiiinnnntttt
  370.       lllleeeennnn ))))
  371.       Writes _l_e_n bytes from    _s to the stream    and returns a
  372.       reference to the stream.
  373.  
  374.       See also:  writeBytes(), QIODevice::writeBlock() and
  375.       readRawBytes().
  376.  
  377.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  378.       hhhhttttttttpppp::::////////wwwwwwwwwwww....ttttrrrroooollllllll....nnnnoooo////qqqqtttt////qqqqddddaaaattttaaaassssttttrrrreeeeaaaammmm....hhhhttttmmmmllll
  379.  
  380.      CCCCOOOOPPPPYYYYRRRRIIIIGGGGHHHHTTTT
  381.       Copyright 1992-1997 Troll Tech AS.  See the LICENSE file
  382.       included in the distribution for a complete license
  383.       statement.
  384.  
  385.      AAAAUUUUTTTTHHHHOOOORRRR
  386.       Generated automatically from the source code.
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.      Page 6                         (printed 9/22/98)
  394.  
  395.  
  396.  
  397.